package com.nidu.demo.dict.api;

import com.alibaba.cola.dto.MultiResponse;
import com.alibaba.cola.dto.PageResponse;
import com.alibaba.cola.dto.Response;
import com.alibaba.cola.dto.SingleResponse;
import com.nidu.demo.dict.dto.DictDataAddCmd;
import com.nidu.demo.dict.dto.DictDataListQry;
import com.nidu.demo.dict.dto.DictDataPageQry;
import com.nidu.demo.dict.dto.DictDataUpdateCmd;
import com.nidu.demo.dict.dto.DictDataCO;

import java.util.Set;

/**
 * 字典数据服务接口
 *
 * @author auto
 */
public interface SysDictDataService {

    /**
     * 创建字典数据
     *
     * @param cmd 字典数据创建命令
     * @return 创建后的字典数据信息
     */
    SingleResponse<DictDataCO> add(DictDataAddCmd cmd);

    /**
     * 更新字典数据
     *
     * @param cmd 字典数据更新命令
     * @return 更新后的字典数据信息
     */
    SingleResponse<DictDataCO> update(DictDataUpdateCmd cmd);

    /**
     * 删除字典数据
     *
     * @param id 字典数据删除命令
     * @return 操作结果
     */
    Response delete(Long id);

    /**
     * 批量删除字典数据
     * @param ids
     * @return
     */
    Response delete(Set<Long> ids);

    /**
     * 获取字典数据详情
     *
     * @param id 字典数据ID
     * @return 字典数据详情
     */
    SingleResponse<DictDataCO> getById(Long id);

    /**
     * 查询字典数据列表
     *
     * @param qry 查询条件
     * @return 字典数据列表
     */
    MultiResponse<DictDataCO> list(DictDataListQry qry);

    /**
     * 分页查询字典数据
     *
     * @param qry 分页查询条件
     * @return 分页结果
     */
    PageResponse<DictDataCO> page(DictDataPageQry qry);
}
